home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 23 / Amiga Format AFCD23 (Feb 1998, Issue 107).iso / -in_the_mag- / emulation / computers / vic / read.me < prev    next >
Text File  |  1997-12-12  |  5KB  |  191 lines
  1.  
  2.         VIC-20 Emulator 
  3.         (Very brief Read.Me)
  4.  
  5. Why:    Because I didn't had a C64 but a VIC-20 before I bought
  6.     an Amiga and to remember 'the good old days' I had to write 
  7.     my own emulator. So here it is ......
  8.  
  9. HowToUse:
  10.  
  11.     This package contains two binairies:
  12.  
  13.     vic-00:    For the 68000 amigas
  14.     vic-20: For the >=68020 amigas 
  15.  
  16.     Usage:
  17.  
  18.     vic-x0 [-k n] [-s n] [$xxxx file  ....]
  19.  
  20.     -k   n    number of Vertical Screen interrupts between
  21.         the VIC-interrupts for the Keyboard.
  22.         (default = 5 (10 per second. Real = 60 per second))
  23.  
  24.     -s   n    number of Vertical Screen interrupts between
  25.         two screen-updates. 
  26.         (default = 12 (4 per second))
  27.  
  28.     $xxxx    Start address where following file must be loaded.
  29.         E.g. vic $8000 char.rom
  30.         places the char.rom-file on address $8000 in the
  31.         VIC-memory map.
  32.  
  33.         There are 2 special filenames:
  34.         ramx:    add ram on the specified address. X stands
  35.             for the size of the memory in Kbytes.
  36.             E.G. vic $2000 ram8
  37.             Add 8K ram to standard vic
  38.  
  39.         nopx:    Define from address to address + x * 1024
  40.             no ram/rom/io. This can be used to overwrite
  41.             default values which are defined in the
  42.             vic-config file.
  43.             E.G. vic $0400 nop3
  44.             Removes 3K which is defined in the vic-config file.
  45.     
  46.     The default memory map of the vic can be defined on two ways:
  47.  
  48.     1) Vic-config: (When started from CLI)
  49.         The 'vic-config' file contains the memory-map.
  50.         Each line contains one address and a file.
  51.  
  52.         E.G.
  53.         $8000    char.rom
  54.         $c000    basic.rom
  55.         $e000    kernal.rom
  56.  
  57.         $0400    ram3        (add 3K ram)
  58.         $2000    ram8        (add 8K ram)
  59.  
  60.     2) vic.icon: (When started from WorkBench)
  61.         The address and file are defined in the tooltypes
  62.  
  63.         E.G.
  64.  
  65.         $8000=char.rom
  66.         $c000=basic.rom
  67.         $e000=kernal.rom
  68.  
  69.         (See examples)
  70.     
  71.         It's also possible to define a project-icon to
  72.         load other files into the memory. 
  73.  
  74.         The default-tool is vic-00 (or vic-20).
  75.  
  76.         ToolTypes should be defined as described above. 
  77.         The ToolTypes mentioned in the project icons
  78.         have a higher priority as the default ToolTypes.
  79.  
  80.  
  81.  
  82.     Loading of basic programs:
  83.  
  84.     Type LOAD when the emulator is started. 
  85.     With the file-requester it's possible to choose
  86.     the file which you want to load. 
  87.  
  88.     With SAVE "filename",8 it is possible to save 
  89.     a program.
  90.  
  91.     (See for more information about how to load a program
  92.      the file Load)
  93.  
  94.  
  95. Keys:    Because the key-matrix is implemented very straight
  96.     forward not all keys have a logical place on the Amiga
  97.     keyboard. The most important differences are shown below:
  98.  
  99.     VIC    |    Amiga        VIC     |   Amiga
  100.     -------+---------        --------+--------
  101.     F2     | SHIFT-F1        "       | @
  102.     F4     | SHIFT-F2        +       | -
  103.     F6     | SHIFT-F4        -       | =
  104.     F8     | SHIFT-F5        =       | F10
  105.     <-     | ` (~)            &       | ^
  106.     '      | &            (       | *
  107.     )      | (            HOME    | <- (BackSpace)
  108.     @      | [            *       | ]
  109.     :      | ;                      [       | :
  110.     ;      | '            ]       | "
  111.     STOP   | CTRL            C=      | ALT
  112.     BACK-SP| DEL            CTRL    | TaB
  113.  
  114.     And of course you have to press SHIFT -> to move the
  115.     cursor to the left and SHIFT V(arrow-down) to move the
  116.     cursor upwards.
  117.  
  118. Speed:    On a 68000 system the next program takes 8.8 seconds
  119.  
  120.     10 FORI=1TO2000
  121.     20 NEXTI
  122.  
  123.     Please send information about other systems!!!
  124.  
  125. Working Games:
  126.     APE_ESCAPE    CAVE_IN            CHOPLIFTER.SYS_40961
  127.     COSMIC-CRUNCHER    COSMIC-JAILBREAK    GOLD_FEVER
  128.     MAZE        MENAGERIE        MOSQUITOS
  129.     ORBIT        PACMAN.ATARI        PREDATOR
  130.     QUAKERS        RAT_RACE        ROADRACE
  131.     ROBOT_PANIC    SARGON_II        SATELLITE_PATROL
  132.     SCORPION    SERPENTINE        TERRAGUARD
  133.     TRASHMAN    VC-EXTRA (No Game)    VIDEOMANIA
  134.     BUCK_ROGERS    DEFENDER        K-RAZY
  135.     LODERUNNER    POLE_POSITION        ROBOTRON
  136.     STAR_PATROL    UBOOT-COMMANDER        SUPER_AMOK
  137.  
  138. Not Working Games:
  139.     ARACHNOID    (Only intro screen)
  140.     CATCH_A_SNATCH
  141.     CENTIPEDE
  142.     CLOWNS        (Only intro-screen)
  143.     ET
  144.     FAST_EDDIE
  145.     GORF        (Only First 2 levels are working. Timers not emulated)
  146.     KONG
  147.     MONEY_WARS    (Only Intro Screen. Keys are not recognized)
  148.     STARPOST    (Joystick and Keyboard are not working??)
  149.     TURMOIL        (Only first screen)
  150.     WACKY_WAITERS_SYS48896    (Works sometimes)
  151.  
  152. Programs:
  153.     Vic-programs can be found on:
  154.     
  155.     ftp.hrz.uni-kassel.de    (/pub/machines/vic-20)
  156.     
  157.     and
  158.  
  159.     nic.funet.fi        (/pub/cmb/vic  ??)
  160.  
  161. Todo:    Improve disk-support.
  162.     Implement 'White Noise'.
  163.     Implement NMI. (restore key)
  164.     Improve interrupts.
  165.     Emulate VIA's.
  166.     Improve Key-mapping
  167.     Make it faster. (or slower when it goes to fast)
  168.     Improve docs.
  169.  
  170.     
  171. Thanks:    Yacco de Leeuw         who supplied the ROM-images
  172.     Frank van Leeuwen    for giving hints for optimizing
  173.                 the 6502-code
  174.     Roeland Kamps        for the video optimizing and the other
  175.                 optimizing tricks
  176.     Andreas Heitmann    for transfering cartridges to files
  177.     Paul Kolenbrander    and his A4000 who showed me the first
  178.                 8MHz VIC ;-).
  179.  
  180. Bug reports, remarks, improvements, $$ (not by E-mail) or 
  181. comments (also positive):
  182.  
  183.     E-Mail etmpile@crosby.ericsson.se
  184.  
  185.     or
  186.     
  187.     Pieter van Leuven
  188.     Kloosterstraat 130
  189.     5688 HT  Oirschot
  190.     Netherlands
  191.